Welcome to SUDS, the brewers database and log program. This program provides a single place to put all of your recipes, log entries and miscellaneous brewing comments. Provided is a full featured multi-windowing editor, a formatted log entry system, Hop IBU spreadsheet, calendar, calculator, label printer and a host of other features. )
Press ESC to put this help screen away.
Calculator
The calculator is a simple four-function calculator with add, subtract, multiply, and divide. To operate the calculator you can either use the keyboard or press the buttons on the calculator with the mouse. The 'C' key clears the calculator, the '
' key will erases the last character typed, and the '
' key toggles the value from positive to negative (the keyboard equivalent of '
' is '_').
Calendar
The calendar displays the current month, highlighting todays date. The next and previous months can be viewed using the '+' or '-' keys respectivly. The mouse can also be used to change the month by pressing the
icons.
About
When you choose the About command from the File menu, a dialog box appears, showing copyright and version information. G
To close the box, press Esc, Space, or Enter, or click the OK button.
File (Alt-F)
The file menu offers the following options: X
Creating
recipe
Changing
existing
recipes
Reading
recipe
ASCII
Saving
recipes
entries
Saving
recipe
ASCII
Deleting
recipes
entries
Open
recipe
Change
directories
Print
recipe
Display
information
about
Shell
Exit SUDS
New Recipe (Alt-N)
Selecting New Recipe from the main menu or pressing Alt-N will open a new recipe editing window to enter new recipe text. See also: Recipe
Window Editor
Commands
Window
commands
Get Template (Alt-T)
Selecting the Get Template option from the main menu or pressing Alt-T will display a selection list of "Template" recipes available in the SUDS database. Any of the selected recipes can be selected using the mouse or keyboard and an untitled recipe window will be displayed with the template text. This provides you with a good start for a particular recipe style from which to create your recipe. 3
Templates in the selection box will be displayed in alphabetic order Pressing any keyboard letter(s) will position you automatically to the first selection starting with the letter(s) keyed. Clicking (or tabbing) to the OK button will select the highlighted recipe as will double-clicking with the mouse.
See also: Recipe
Window 4
Editor
Commands
Window
commands
Get Recipe (F3)
Selecting the Get Recipe option from the main menu or pressing the F3 key will display a selection list of existing recipes in the SUDS database. Any of the displayed recipes can be selected using the mouse or keyboard and is then displayed in a window for further editing.
Recipes in the selection box will be displayed in order of the recipe category (ie Pale Ale) or in raw alphabetic order depending on the option selected from the Sort
Order selection under Options on the main menu.
Pressing any keyboard letter(s) will position you automatically to the first selection starting with the letter(s) keyed. Clicking (or tabbing) to the OK button will select the highlighted recipe as will double-clicking with the mouse. x
If a filter is active, an UnFilter button will also be displayed. Pressing this button will clear the current filter.
See also: Recipe
Window U
Editor
Commands
Window
commands
Filtering
Recipes
Filtering SUDS Recipes
The Filter function from the Search menu allows you to limit the recipes shown in the Get Recipe window based on search parameters that you specify.
When your recipe list gets into the hundreds (which it will if you use my utility to add Cat's Meow files - SUDSCM!), this can greatly reduce time spent searching recipes.
The Filter dialog box allows you to limit recipes shown by their Category, Method, minimum and maximum gravities or alcohol content and by text contained within the recipe.
For all options except recipe text, only recipes meeting ALL of the criteria are selected. For recipe text searches, you may enter one search phrase per line. If ANY one of the search phrases is found within the recipe, it is selected (providing that it meets all other non-text search criteria). Its a good idea to limit the search as much as possible with non-text fields since text searches are more time consuming.
Once the search has been performed, the recipe selection list shows only recipes meeting the filter options specified. The filter remains in effect until you end the program, press the Cancel button or press the Unfilter button from the Get
Recipe dialog box.
Recipe Window
Any number of recipe and log windows can be open at one time (limited only by available memory). The first 9 windows open will have a window number assigned (1-9). X
Pressing Alt and the window number will take you directly to the corresponding window. r
Within the recipe window you may type any text or paste text into the window that was cut from any other window.
When you complete the recipe text, selecting Save or pressing F2 will allow you to save the recipe into the SUDS database. Selecting Export
recipe
file will allow you to save the text to an ascii file.
Selection Screens
Often during your SUDS session, you will need to select Recipes or log entries from a list box. The list box contains a list of recipes or log entries, an OK button and a Cancel button. q
To select the highlighted item, either double-click on a displayed item with the mouse, or press the OK button.
The arrow keys or the page up/down keys will navigate through the list. You can also click on the scroll bar with the mouse to move through the entries. k
Keying any letter from the keyboard will position you at the first entry beginning with the letter keyed.
Save... (F2)
Selecting the Save option from the file menu or pressing F2 will do one of two things. r
If the currently selected window is a log window, the information will be saved or updated in the SUDS database.
If the currently selected window is a recipe window, the Suds
Recipe
Details window will be displayed where you will confirm or enter further recipe information which will then be saved or updated in the SUDS database.
Recipe Details
The SUDS Recipe details screen is displayed whenever you are saving or updating recipe details in the SUDS database. This screen allows you to enter or change the Recipe Name, Recipe Category (ie Pale Ale, Stout, etc.), Recipe method (Extract, Mash, etc.), starting and finishing gravities, quantity and ageing time. c
The Category and Extract fields both allow you to either key in a value or select a value from a list. To display the list while in these fields either click on the down arrow icon on the screen with the mouse or press the down arrow key on the keyboard. This displays a values list. To select a value, either double-click on the value or press enter. }
Pressing the OK button will save or update the recipe in the SUDS database. Pressing Cancel will return you to the editor.
Delete
Selecting Delete from the file menu will allow you to delete a recipe or log entry.
If the currently selected window is a log or recipe window, you will be prompted to confirm the deletion. Selecting Yes will then delete the current recipe or log entry and close that window.
If no windows are opened, a recipe selection list is displayed to select a recipe to delete. Selecting a recipe will bring up the confirmation screen. Selecting Yes will then delete the recipe.
Read Recipe from ASCII File
The Open File option from the file menu displays a Open a File dialog box. This option would be used to open a recipe text file in ascii format allowing you to save the recipe in your personal SUDS database. &
The Open
File dialog box contains:
an input
box with a history list
a list
box to browse the directory
the standard Cancel button
Open action button
an information panel that describes the
selected file
Save to File
The Save recipe to file option from the main menu will allow you to save the currently open recipe to an ASCII file. This allows you to create stan- dard files for printing or uploading to other brewers. You could also use this option to export a SUDS recipe allowing you to edit the recipe with any other editor or word processor besides the integrated SUDS editor.
Open Log Alt-L
Selecting the open log option from the file menu will allow you to add or select a log entry for further editing. The log list will show log entries for the current recipe window if any is active. Otherwise the full log for all recipes will be listed in descending date order. Double-clicking on an entry or pressing the OK button will bring up the Log
Window for the log entry.
Log Window
The log window is where you will make most of your notes relating to a particular batch of beer. The information captured includes date started, date bottled, starting gravity, finishing gravity, Hop IBU rating and free-form notes.
The date fields allow you to enter a date or jump forward or backward by a day when pressing "+" or "-". Clicking the right mouse button while on a date field will display a calendar for the current month.
Clicking the right mouse button or selecting the Hop IBU worksheet option from the Tools menu will display the Hop
worksheet which will calculate the Hop
IBUs for your beer batch.
Most of your information will go into the free-form note area (your "notebook"). This area allows all editing commands just like the recipe editor does.
See also : Editor
Commands
Print (Alt-P)
Selecting the print option from the file menu or pressing Alt-P when a recipe or log window is open allows you to print the recipe and/or log entry.
Each type of window in SUDS will react differently to the print option. If the window is a recipe from the SUDS database, you will be shown a Print
Recipe
dialog
box.
If the window is a file that hasn't been saved in the SUDS database, you'll receive a confirmation message to print the current file with the options, Yes, No or Cancel. Selecting the Yes button will print the file. t
For a log window, a confirmation message will also be displayed. Selecting Yes will print the current log entry.
Print Recipe Dialog Box
When printing a recipe from the SUDS database, the Print Recipe dialog box is displayed. Here you can specify whether or not the Recipe text, recipe stats (gravities, etc) and log entries are to be printed for the recipe.
These options are selected by clicking on the selection boxes with the mouse, or by tabbing to the selection box and pressing "X" or spacebar.
Hop IBUs
Hop IBUs (International Bittering Units) are a worldwide standard of bitterness measurement based on hop isomerization (how readily the alpha acids are converted to iso-alpha acids) and the percentage of alpha acids contained in the hops used.
DOS Shell
With the DOS Shell command, you can leave the program temporarily to perform a DOS command or run another program. 9
To return to this program, type EXIT at the DOS prompt.
Exit
(Alt-X)
The Exit command terminates this program.
Edit (Alt-E)
The Edit menu offers the following options: |
Undo
previous
change
block
Copy
block
Paste
block
Show
Clipboard
Clear
Undo
Selecting undo from the Edit menu will undo the last change you made within the integrated SUDS editor.
See also : Editor
Commands
Cut
(Shift-Del)
After marking a block of text with the mouse or keyboard block command, selecting Cut from the Edit menu or pressing Shift-Del will remove the block from the editor and put the block into the Clipboard from where it may be pasted into another location or window.
See also : Editor
Commands
Copy
(Ctrl-Del)
After marking a block of text with the mouse or keyboard block command, selecting Copy from the Edit menu or pressing Ctrl-Del will copy the block from the editor into the Clipboard from where it may be pastedinto another location or window.
See also : Editor
Commands
Copy
(Shift-Ins)
Once a block of text has been cut or copied into the clipboard, selecting paste from the Edit menu or pressing Shift-Ins will copy the text from the clipboard into the current location within the current window.
See also : Editor
Commands
Show Clipboard
Selecting the show clipboard option from the edit menu will show the current contents of the SUDS clipboard. The clipboard is used to transfer text to and from windows.
See also : Editor
Commands
Clear
Selecting the clear option from the edit menu will clear the contents of the currently selected window.
See also : Editor
Commands
Search (Alt-S)
The Search menu offers the following options: A
Find
Search
replace
Search
again
Find text
Selecting the find option from the Search menu will display the find window which allows you to specify the text to search for, whether or not the search should be text sensitive and whether or not the search should be limited to whole words only.
Pressing the down arrow key or selecting the down-arrow icon will display the previous text search strings that you entered and will allow you to select any of these.
The Case sensitive and Whole words only options will toggle on and off when you click on them with the mouse or press the space bar when they are focused.
Replace text
Selecting the replace option from the search menu will display the replace window which allows you to specify the text to be replaced, the text to replace it with, whether or not the search is case sensitive, whether or not the search is limited to whole words, whether or not you should be prompted for each replace and whether or not all found text should be replaced.
The text to find field allows you to enter text to search for. Pressing the down arrow key or clicking on the down arrow icon will display a pick-list of previous search strings. u
The New text field allows you to specify the text to replace the found text above. This also has a pick-list icon.
Search Again
Selecting the Search Again option from the search menu will repeat the last search command that you entered.
Options (Alt-O)
The Options menu offers the following options:
Sort
Order
recipe
lists
Pack
database
Export
recipes
Import
recipes
Sort Order
Selecting the Sort Order option from the Options menu displays a selection box which allows you to select the sort order to be used for recipe lists and searching in SUDS. The options are by recipe categore (ie Pale Ale) or alphabetic by recipe name.
To select an option, click on the radio button with the mouse or press the up and down arrows when the selection box is highlighted. i
Pressing the OK button will save your change and pressing the Cancel button will ignore your selection.
Pack SUDS database
Selecting the Pack Database option from the Options menu will "pack" and reorganize all of the internal files used within the SUDS database.
Because SUDS uses XBASE files, they can eventually become full of unused space as recipes are edited, changed and deleted. Packing the database will reclaim any unused space, optimize the indexes used by the system and save space on your hard disk.
Export recipes to .SXF file
Selecting this option from the Options menu will prompt you for a file name and will copy all of your recipes to the selected file name in a format that other users of SUDS can import into their databases.
This option will display a file selection screen from which you can enter a new file to export to, or select an existing file which would be overwritten. The file you select MUST have an extension of ".SXF". &
This is the easiest way to share your recipes with others. You can't simply copy your database since this would then overwrite another users database. You also have the option of saving individual recipes into text files allowing you to share single recipes with users and non-users of SUDS.
Import recipes from .SXF file
Selecting this option from the Options menu will allow you to import any SUDS .SXF files that you export or obtain from other SUDS users. SXF files are the easiest way to share recipes with other brewers using SUDS.
This option will present a list of all .SXF files in the current directory. You may select an existing .SXF file or a directory name to navigate through other directories. (
The SXF
list dialog box contains:
an input
box with a history list
a list
box to browse the directory
the standard Cancel button
Open action button
an information panel that describes the
selected file
Tools (Alt-T)
The Tools menu offers the following options: `
Pop-up
Calculator
window
Pop-up
Calendar
window
Worksheet
Print
labels
Print Beer Labels
When inside a log window in SUDS, selecting Print Beer Labels from the Tools menu will bring up the print label dialog box. This box displays a sample of the beer label, the number to be printed along with an OK and Cancel button.
You can edit any of the information to be printed on the label. By default, the recipe name, bottling date, batch number, starting and finishing gravities and alchohol content will appear on the labels.
SUDS uses standard mailing labels (one-up only) to print beer labels. SUDS will estimate the number of labels to print based on the recipe volume. You can override the number of labels to print.
Window
(Alt-W)
The Window menu contains commands to close, move and perform other window-management commands.
Most of the windows in this program have all the standard window elements, including scroll bars, a close box, and zoom icons. >
For more about windows and their elements, refer to windows. :
Window-management commands
Size/Move Zoom
Tile Cascade
Next Previous
Close
Window
Size/Move
(Ctrl-F5)
Choose this command to change the size or position of the active window.
Size
If you press Shift while you use the arrow keys, you can change the size of the active window. Once you've adjusted its size or position, press Enter. Q
If a window has a Resize corner, you can drag that corner to resize the window.
Move
When you choose Window
Size/Move, the active window moves in response to the arrow keys. Once you've moved the window to where you want it, press Enter. F
You can also move a window by dragging its title bar with the mouse.
Window
Zoom
(F5)
Choose Zoom to resize the active window to the maximum size. If the window is already zoomed, you can choose this command to restore it to its previous size. {
You can also double-click anywhere on the window's title bar (except where an icon appears) to zoom or unzoom the window.
Window
Tile
Choose Window
Tile to tile all windows on the desktop. L
Tiled Windows
Window
Cascade
Choose Window
Cascade to stack all windows on the desktop. A
Cascaded Windows
Window
Next
Choose Next to cycle forwards through the windows on the desktop.
Window
Previous
Choose Previous to cycle backwards through the windows on the desktop.
Window
Close
(Alt-F3)
Choose Close to close the active window. N
You can also click the Close box in the upper left corner to close a window.
Hop IBU Information Worksheet
The Hop IBU worksheet allows you to enter information about the hops used in your recipe (up to 4 "hoppings") and calculates the International
Bittering
Units.
On the worksheet you enter the quantity of the hops in ounces, the name of the hop (selecting the downarrow will display a picklist of hop names), the AAU rating of the hops (usually provided on the hop container and the time the hops were boiled in the wort.
Using this information, the worksheet will calculate the hop IBUs for the batch and will fill in the Hop IBU field on the Log
Window
Help on Open a File Dialog Box
The Open a File dialog box contains an input box, a file
list, a file information panel, the standard button Cancel, one other action button (Open), plus a history list that's attached to the Name
inputbox.
Name
The Name input box is where you enter the name of the file to load, or the file-name mask to use as a filter for the Files list box (for example, *.*).
Files
FILENM01.PAS
FILENM09.PAS
FILENM02.PAS
FILENM10.PAS
FILENM03.PAS
FILENM11.PAS
FILENM04.PAS
FILENM12.PAS
FILENM05.PAS
..
FILENM06.PAS
\MOREXAMP
FILENM07.PAS
\TOURS
FILENM08.PAS
\ANSWERS.DIR
The Files list box lists the names of files in the current directory that match the file-name mask in the Name input box, plus the parent directory and all subdirectories.
C:\TP\EXAMPLES\*.PAS
HELLO.PAS 52 Jul 14,1990 12:00pm
The File information panel shows the path name, file name, date, time, and size of the selected file. =
None of the items on this information panel are selectable.
[ Open ]
The Open button opens a new window and places the selected recipe in that window.
[ Cancel ]
If you choose Cancel, nothing changes and no action occurs, and the dialog box is put away. M
(Esc always cancels a dialog box, even if a Cancel button does not appear.)
[ Open ]
In the Open a File dialog box, if you choose the Open button SUDS opens a recipe edit window and places the selected recipe in that window.
Help on the Change Directory dialog box
The Change Directory dialog box consists of an input box, a list box, the standard OK and Help buttons, and two other buttons (Chdir and Revert). |
Directory Name
The Directory Name input box is where you type in the path of the new directory.
Directory Tree
Drives
C:\
TP
TVISION
The Directory Tree list box enables you to navigate directories by using the selecting bar and pressing Enter.
If you're using the keyboard, press Enter to make the selected directory be the current directory, then choose OK or press Esc to exit the dialog box. +
[Chdir ]
The Chdir button changes the current directory once you've selected or typed in a directory name. +
[Revert]
The Revert button goes back to the previous directory, as long as you haven't yet exited the dialog box.
Edit Windows
Edit windows are used in SUDS to enter and update recipe text and to edit and update recipe log notes. u
You can open as many Edit windows as you want, but SUDS only numbers the first nine windows (of any kind) you open. l
Closing and Opening Edit Windows
To close an active Edit window, click the window's close box or choose Window
Close. _
To open an Edit window, choose File
Open. You can open the same file in more than one window. H
For More Information
Choose one of these for more information: 1
windows
Windowing
commands
The SUDS Editor
There are many ways to get into an open Edit window (make it active):
1) Click it.
2) Press Alt-# (where # is that Edit
window's number).
3) Press (or click) F6 to cycle through the
open windows.
To close the active Edit window, choose Window
Close. Q
Once in the Edit window, you enter text just as if you were using a typewriter. P
When you want to end a line, press Enter.
To exit the editor, press F10.
The maximum line width in an Edit window is 249 characters; you'll get a beep if you try to type past that.
See also:
window Cursor
Movement
Commands
Insert
Delete
Commands Block
Commands
Miscellaneous
Commands File
Commands
Cursor Movement Commands
Character left
Ctrl-S or Left arrow
Character right
Ctrl-D or Right arrow
Word left
Ctrl-A or Ctrl-Left arrow
Word right
Ctrl-F or Ctrl-Right arrow
Line up
Ctrl-E or Up arrow
Line down
Ctrl-X or Down arrow
Scroll up
Ctrl-W
Scroll down
Ctrl-Z
Page up
Ctrl-R or PgUp
Page down
Ctrl-C or PgDn
Insert & Delete Commands
Insert mode on/off
Ctrl-V or Ins
Insert line
Ctrl-N
Delete line
Ctrl-Y
Delete to end of line
Ctrl-Q Y
Delete character left
Ctrl-H or Backspace
Delete character
Ctrl-G or Del
Delete word right
Ctrl-T
Block Commands
Using mouse - Using the mouse, a block is marked by simply holding down the left mouse button and dragging over the area to be marked. >
(.txt)